package com.example.demo.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.example.demo.domain.dto.CategoryQuery;
import com.example.demo.domain.entity.Category;
import com.example.demo.domain.vo.CategoryVO;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * @author renliang
 */
public interface CategoryService extends IService<Category> {
    /**
     * 分页查询
     *
     * @param page  分页参数
     * @param param 查询参数
     * @return 查询结果
     */
    IPage<Category> customizePage(IPage<Category> page, Category param);

    /**
     * 列表查询
     *
     * @param param 查询参数
     * @return 查询结果
     */
    List<Category> customizeList(CategoryQuery param);

    /**
     * 更新
     *
     * @param param 参数
     * @return 更新结果
     */
    Category updateCategory(Category param);

    /**
     * 新增
     *
     * @param param 参数
     * @return 新增结果
     */
    Category addCategory(Category param);

    /**
     * 分类删除
     * 只能删除叶子节点，不支持级联删除，如果存在叶子节点抛出异常
     *
     * @param ids 主键ID集合
     */
    void deleteByCategoryIds(List<Long> ids);

    /**
     * 根据ID级联删除分类
     *
     * @param ids ID集合
     */
    void deleteWithChildByCategoryIds(List<Long> ids);

    /**
     * 查询树形结构数据
     *
     * @param param 查询参数
     * @return 树形结构
     */
    List<CategoryVO> tree(CategoryQuery param);

    List<CategoryVO> buildTree(List<Category> list);

    /**
     * 根据父节点查询所有的子节点
     *
     * @param parentId 父节点ID
     * @param cascade  是否级联查询
     * @return 所有的子节点
     */
    List<Category> getByParentId(Long parentId, Boolean cascade);

    /**
     * 删除分类
     *
     * @param ids     分类ID集合
     * @param cascade 是否级联删除
     */
    @Transactional(rollbackFor = Exception.class)
    void deleteCategory(List<Long> ids, Boolean cascade);
}
